home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 185 (1991-12-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 185 (1991-12-10)(Manewaldt, A.)(DE)(PD).adf / PowerP-Tools / PPShow12b.doc / PPShow12b.doc
Text File  |  1991-11-30  |  9KB  |  227 lines
  1.  
  2.  
  3.                             PPShow 1.2 User Manual
  4.  
  5.                                  Sep 28, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    The programs and files in this distribution are freely distributable, but
  13. are also copyright (c) Nico François.  They may be freely distributed as long
  14. as no more than a nominal fee is charged to cover time and copying costs.
  15.    No commercial usage is permitted without written permission from the
  16. author.  Everything in this distribution must be kept together, in original
  17. unmodified form.
  18.    The above is generally known as freeware.
  19.  
  20.  
  21.    Coverdisks or diskmagazines need written permission of UGA to offer the
  22. Powerpacker utilities or Powerpacker/Reqtools libraries on their disk. For
  23. commercial use please read the copyright file on your original PP disk.
  24.  
  25.  
  26.    If you have suggestions or remarks about this program, or if you find
  27. any bugs, please let me know.
  28.  
  29.    Write to the following address:
  30.  
  31.                                 Nico François
  32.                                 Corbielaan 13
  33.                                 B-3060 Bertem
  34.                                 BELGIUM
  35.  
  36.  
  37. Contents
  38. ========
  39.  
  40. 1. An introduction
  41.  
  42. 2. Usage
  43.  
  44. 3. Features
  45.  
  46. 4. Note on crunching
  47.  
  48.  
  49. 1. An introduction
  50. ==================
  51.  
  52.      PPShow was written to complement one of my other utilities, PowerPacker
  53. (a command and data cruncher).  It is used to show normal IFF ILBM files or
  54. ILBM files crunched with PowerPacker.  The decrunching is done automatically
  55. so the user doesn't have to know if a file is crunched or not.
  56.  
  57.      PPShow uses 'powerpacker.library' and 'reqtools.library', so make sure
  58. these are present in your Libs: directory.  Double-click 'Install_libs' for
  59. an automatic installation.
  60.  
  61.      If you haven't got PowerPacker you are of course missing one of the main
  62. features of this program.  PowerPacker is available as shareware (up to
  63. version 2.3b) or as a commercial program (version 4.0a).  Order a copy from
  64. UGA, P.O.Box 881, 3700 AW Zeist, The Netherlands.  The commercial version
  65. offers several enhancements like 40 to 50 times faster crunching, overlay
  66. support, an ARexx port, and much more.
  67.  
  68.  
  69. 2. Usage
  70. ========
  71.  
  72.      PPShow can be used in four different ways.
  73.  
  74. - First of all via the CLI:
  75.  
  76.      If you enter PPShow without arguments you will get a usage template.
  77. You use PPShow like this:
  78.  
  79.      PPShow [-h] [<file|dir>]
  80.  
  81.      The program will then load the ILBM file and display it.  If the file
  82. was crunched using PowerPacker 2.0 or higher PPShow will first decrunch it
  83. for you.  If the file was encrypted you will be prompted for the password.
  84.      If you enter PPShow without options, you will be presented with a file
  85. requester.  Entering PPShow with a directory instead of a file as an argument
  86. will also get you a file requester, but it will be positioned in the directory
  87. you specified.
  88.      There is only one option in this version: '-h'.  This option is used to
  89. force HAM mode when no CAMG chunk is found.  If you don't specify this option
  90. PPShow will assume a 6 plane screen is extra half brite. (Note that it is
  91. wrong for an Amiga IFF ILBM file not to have a CAMG chunk, especially when
  92. there can be doubt about what display mode to pick !)
  93.      PPShow can be made resident so it doesn't have to be loaded every time
  94. you use it, use the ARP ARes command or the c: Resident command for this.
  95. You can't make PPShow resident when it is crunched !!  The file is supplied
  96. as an uncrunched command file with the pure bit set.  PPShow is reentrant as
  97. well, so you can run it from several CLI's at the same time. (Not that this
  98. is very useful, but it's possible :-D)
  99.  
  100.      Example:       '1> PPShow -h dh0:pics/HAMpicWithoutCAMG.pic'
  101.  
  102. - Via the WorkBench:
  103.  
  104.      There are three different ways of using PPShow via the workbench: you
  105. can set the default tool of the (crunched) ILBM file to 'PPShow', you can
  106. single click the PPShow icon and then double click the picture icon or you
  107. can double-click the PPShow icon and enter the filename in the string gadget
  108. you will be presented with.
  109.      You set the default tool by single clicking the icon of the picture
  110. and selecting 'Info' from the workbench menu.  You will get a window with
  111. several gadgets in it, click in the string gadget where it says 'Default
  112. tool' and enter ':ppshow'.  PPShow should be in the root directory of your
  113. disk for this to work, if e.g. it's in the system directory you should enter
  114. ':system/ppshow'.  Last of all select the 'Save' gadget.
  115.  
  116. NOTE: - PPShow will add '.pp' to the filename when the file wasn't found.
  117.         This is very useful in the WorkBench enviroment: you can make an
  118.         icon for 'house.pic' but name the file 'house.pic.pp'.  Now the
  119.         WorkBench will show an icon with 'house.pic' as name, but if you
  120.         doubleclick it 'house.pic.pp' will be displayed. (As long as there
  121.         is no 'house.pic' file in the directory !)
  122.  
  123.  
  124. 3. Features
  125. ===========
  126.  
  127.    - PPShow uses the file requester of reqtools.library.
  128.  
  129.    - Abort PPShow by pressing any key (except <TAB> or 'P') or the right
  130.      mouse button.  The screen can be dragged by an invisible drag bar at
  131.      the top.
  132.  
  133.    - The pesky little mouse will be removed while displaying.
  134.  
  135.    - PPShow offers full overscan support, PAL or NTSC.  As far as I know
  136.      this is the first ILBM viewing program to do so, looks like PAL Amiga
  137.      owners still get forgotten.  All Amiga display modes (like HAM, EHB)
  138.      are of course also supported.
  139.  
  140.    - Deluxe Paint cycling is supported, press <TAB> to (de)activate.  Up to
  141.      8 cycles are supported (DPaint III currently only supports 6).
  142.  
  143.    - PPShow has the ability to print the screen it is displaying, all you
  144.      have to do is press 'P' on the keyboard and wait.  The mouse pointer
  145.      will be visible while printing.  Please note that the printer.device has
  146.      to be in the 'devs:' directory for PPShow to be able to print, you
  147.      should also have a correct system-configuration for your printer.
  148.  
  149.    - Press 'L' to load another picture, you will be prompted for a filename.
  150.  
  151.  
  152. 4. Note on crunching
  153. ====================
  154.  
  155.      A lot of IFF ILBM files are already crunched with the standard ByteRun1
  156. compression.  PowerPacker will crunch these files even further (most of the
  157. time) but will not crunch them as well as uncrunched ILBM files.  So save IFF
  158. files uncrunched (if you can, e.g. with PixMate) before crunching them, this
  159. way you will get the best crunching results.
  160.  
  161.  
  162.                       As always, I hope you find this program useful !
  163.  
  164.  
  165.                               PROGRAM HISTORY:
  166.  
  167. *****************************************************************************
  168. VERSION 1.0
  169.  
  170.      First release.
  171.  
  172. *****************************************************************************
  173. VERSION 1.1
  174.  
  175.      Decrunching is about 40% faster (accidently used slow decruncher in 1.0)
  176.      Screen now pops to front when picture is ready to be viewed, not before.
  177.      Filerequester used when arp.library is available.
  178.      'L' command added to load other pictures without restarting PPShow.
  179.  
  180. *****************************************************************************
  181. VERSION 1.1a
  182.  
  183.      The Guru isn't with me lately, after using a slow decruncher in 1.0
  184.        by accident I now used a fast but faulty decruncher in 1.1. It
  185.        sometimes didn't decrunch correctly, this has now been fixed. The
  186.        decruncher is still 40% faster than the 1.0 one. (and it's 2 bytes
  187.        shorter :^D )
  188.  
  189. *****************************************************************************
  190. VERSION 1.2
  191.  
  192.      Rewritten cycling routine in assembly, so less overhead when cycling.
  193.      Uses the all new powerpacker.library => shorter code.
  194.      Starting PPShow from the CLI with a directory as an argument now puts
  195.        up the requester positioned in that directory. Extremely useful once
  196.        you get used to this :^)
  197.      If you are running Workbench 2.0 PPShow will use the asl.library
  198.        instead of the arp.library (for the filerequester).
  199.      Fixed serious bug: memory wasn't freed when an IFF error occured.
  200.      No longer tries to display small brushes (intuition doesn't like very
  201.        small screens :( )
  202.  
  203. *****************************************************************************
  204. VERSION 1.2a
  205.  
  206.      Seemed that the asl requester no longer worked on the latest
  207.        Kickstart 2.0 (release V37). Fixed.
  208.      Asl requester doesn't show '.info' icon files.
  209.  
  210. *****************************************************************************
  211. VERSION 1.2b
  212.  
  213.      Asl and Arp requester removed.
  214.      PPShow now uses the ReqTools file requester from reqtools.library.
  215.      Canceling the file requester will no longer load the last picture
  216.        again.
  217.  
  218. *****************************************************************************
  219.  
  220. PPShow 1.2b written by Nico François (Yes, Nico is my first name :-)
  221.  
  222. (c) 1991 Nico François
  223.  
  224.                                    //
  225.                        Thanks to \X/ Amiga for being the best computer ever !
  226.  
  227.